Arena Software
CLUB TERMINAL
Toate drepturile de autor rezervate (c) 1999-2000 Marius David

GHIDUL UTILIZATORULUI

Cuprins :

  1. Fisiere de Configuratie
  2. Utilizatori
  3. Profiluri

3.1. Lista cu jocuri/programe
3.2. Lista cu clasamentul
3.3. Imagini

  4. Profiluri Utilizator
  5. Setarea Timpului
  6. Afisarea Raportului
  7. Optiuni
  8. Path-uri
  9. Interfata Grafica
10. Descrierea Comenzilor si Variabilelor

10.1 Scrierea de comentarii
10.2 Delimitarea comenzilor
10.3 Lista comenzilor
10.4 Lista variabilelor

Descriere :

Toate setarile din Club Terminal sunt facute cu ajutorul fisierelor de configuratie (*.cfg). Cand porneste programul se executa fisierul default.cfg din directorul aplicatiei, daca acesta nu exista, el este creat. Din fisierul default.cfg se pot face salturi spre alte fisiere de configuratie specificate prin comanda “call” (vezi “Descrierea Comenzilor si Variabilelor”). In fisierele de configuratie se introduc comenzi si se modifica variabile. Variabilele si comenzile sunt descrise in sectiunea “Descrierea Comnezilor si Variabilelor”.

2. Utilizatori :

Club Terminal permite lucrul cu utilizatori, acestia pot avea diferite drepturi in functie de rolul lor in retea. Drepturile sunt orice combinatie intre 5 nivele de acces standard :
1 = acces la lista de jocuri/programe
2 = acces la explorer
4 = acces la setat timp
8 = acces la optiuni si consola
16 = acces la raport

Exemplu : acces 7 inseamna ca utilizatorul are acces la lista cu jocuri + explorer + setat timp

Utilizatorii se vor crea numai din cadrul programului. Pentru aceasta trebuie sa aveti acces la optiuni. Apasati butonul stang al mouseului pe imaginea principala pentru a deschide fereastra cu optiuni. Introduceti datele utilizatorului (Nume, Profile, Parola, Acces) si apoi apasati “add user” pentru a crea un nou utilizator. Pentru a sterge un utilizator, cautati-l in lista cu utilizatori si apasati “delete user”.
Fiecare utilizator are asociat un profil. Cand acesta se autentifica in program automat i se va asocia profilul respectiv.

Exemplu de utilizatori:
adduser 15 games Admin 6AE59D06ADE04010139E157EB1

Pentru a schimba utilizatorul curent apasati cu mouse-ul pe imaginea principala.

3. Profiluri :

Profilurile sunt seturi formate din imagini + clasament + lista de jocuri/programe. Un profil ocupa un director pe hard-disk. Profilurile se creaza manual. Profilurile sunt setate in config prin comanda “addprofile” (vezi “Descrierea Comenzilor si Variabilelor”).

Exemplu de profiluri:
addprofile “games” “\\Server\Club\Profiles\Games”
addprofile “internet” “\\Server\Club\Profiles\Internet”
addprofile “work” “\\Server\Club\Profiles\Work”

Aveti grija ca directoarele sa existe si sa aveti minim drept de citire in ele. Directoarele respective se vor crea manual. Pentru inceput puteti sa multiplicati directorul “Info” si mai apoi sa modificati in director ceea ce este necesar.

Se afla in directorul profilului si are numele de gameinfo.txt. Structura este simpla : pe prima linie se afla numele jocului, pe a doua linie pathul executabilului, pe a treia linie se afla pathul unde se va rula executabilul si pe ultima linie optional se pot scrie parametrii pentru executabil.

Exemplu (fragment din gameinfo.txt):
Quake 3
c:\quake3\quake3.exe
c:\quake3\

Delta Force
c:\dforce\df.exe
c:\dforce\

...

Observatie:
Orice joc trebuie neaparat sa ocupe patru linii in fisier iar primul joc sa inceapa cu prima linie din fisier. Primele doua jocuri (primele opt linii din fisier) sunt asociate celor doua imagini din interfata grafica chiar daca acestea exista sau nu. Inepand cu al treilea joc, toate celelalte vor fi introduse in aceeasi ordine in lista cu jocuri.

3.2. Lista cu clasamentul :

Se afla de asemenea in directorul profilului si are numele de g1info.txt. Structura este urmatoarea : pe prima linie se afla numele jucatorului iar pe a doua scorul sau.

Exemplu (fragment din g1info.txt):
marius.tm.ro
100
Cyberia RO
80

3.3. Imagini :

Se afla in directorul profilului si sunt imagini de tip bitmap cu 256 culori. Au urmatoarele nume si semnificatie :

dialog_*.bmp – sunt imaginile care alcatuiesc marginile ferestrelor de dialog
explorer.bmp – icoana care lanseaza in executie windows explorer (explorer_.bmp cand mouseul trece deasupra icoanei)
g1.bmp – icoana care lanseaza in executie primul joc (g1_.bmp)
g2.bmp – icoana care lanseaza in executie al doilea joc (g2_.bmp)
logoff.bmp – icoana care executa comanda logoff (logoff_.bmp)
main.bmp – imaginea principala a profilului
restart.bmp – icoana care executa comanda restart (restart_.bmp)
shutdown – icoana care executa comanda shutdown (shutdown_.bmp)
start.bmp – icoana cu care se porneste un joc din lista (start_.bmp)

Sunt utilizatori mai speciali, ei sunt atribuiti unei statii atunci cand se seteaza timpul. Au aceeasi structura cu utilizatorii normali mai putin parola care lipseste.

5. Setarea Timpului :

Este facuta de catre un utilizator care are acest privilegiu (acces 4). Trebuie specificat timpul in unitati, profilul utilizator si statia pe care se seteaza timpul. Statiile pe care se poate introduce timpul sunt setate intr-un fisier de configuratie cu comanda “addstation” (vezi “Descrierea Comenzilor si Variabilelor”). In momentul in care se seteaza timpul, in locatia “timepath” se salveaza intr-un fisier cu numele ktime_STATIONNAME.txt (unde STATIONNAME se inlocuieste cu numele statiei pe care se seteaz timpul) o linie cu urmatoarea structura :
<aaaa-mm-ll,oo:nn> TIME PROFILE USERNAME USERSTATUS UNITPRICE
Unde aaaa, mm, ll, oo, nn sunt inlocuite respectiv cu anul, luna, ziua, ora, minutul curent iar TIME este timpul care se aloca statiei, PROFILE, USERNAME, USERSTATUS, UNITPRICE se iau din profilul utilizator selectat.

Exemplu :
<1999-12-10,20:35> 60 quake quake 1 166.6

Observatie :
Pentru a putea seta timpul pe orice statie din retea este obligatoriu ca toate timepath-urile de pe fiecare statie in parte sa indice aceeasi locatie.

Necesita un utilizator autorizat (acces 16). Se afiseaza apasand cu mouse-ul textul “Show Report” din dreapta sus. Daca toate setarile sunt corecte, programul va aduna toate informatiile de pe statiile introduse (poate dura cateva secunde) si va afisa o lista cu raportul generat. Acesta consta dintr-o lista cu fiecare zi gasita in fisiere si suma incasata in ziua respectiva. La sfarsit se va afisa totalul incasarilor pe toate zilele gasite in fisiere si o medie a incasarii pe zi.

7. Optiuni :

Necesita un utilizator autorizat (acces 8). Se acceseaza apasand cu mouse-ul pe imaginea principala (in centrul ecranului). Din fereastra de optiuni se poate seta ce shell sa se execute la urmatoarea pornire a windowsului. Daca se selecteaza Windows Explorer, windows-ul va porni normal. Se pot adauga si sterge utilizatori (vezi sectiunea Utilizatori).

8. Path-uri :

Exista doua path-uri folosite de catre program : logpath (pathul unde se salveaza jurnalul statiei), timepath (pathul unde se memoreaza timpul ramas). Pentru o arhitectura cu server, toate statiile trebuie sa aiba pathul setat pe server (ex: set logpath \\Server\Club\Log; set timepath \\server\time) (vezi “Descrierea Comenzilor si Variabilelor”).

9. Interfata Grafica :

Programul vine cu o interfata standard dar aceasta se poate foarte usor modifca si in plus se pot aduga si altele. Interfata grafica este compusa din : o imagine principala , doua imagini ale celor mai importante doua jocuri/programe, o lista cu toate jocurile/programele, un clasament (optional), lista cu toate statiile din retea si cat timp mai are fiecare. Pentru ca utilizatorul sa nu ruleze din greseala mai multe jocuri simultan, dupa fiecare joc lansat nu se mai poate lansa alt joc timp de cateva secunde (variabila cooltime). Mai exisista si o consola pentru utilizatorii avansati (accesibila cu tasta ` )

Utilizatorii cu drepturi au acces si la windows explorer precum si la alte optiuni ale programului.

10. Descrierea Comenzilor si Variabilelor

- orice linie care incepe cu // sau cu ; se numeste linie comentariu si nu are nici un efect in cadrul executiei;

Folosire: // <comentariu> sau ; <comentariu>
Exemplu: // Acest fisier a fost actualizat in data de 1999.12.15

10.2 Delimitarea comenzilor

Folosire: cmd1;cmd2;cmd3...
Exemplu: set promptlogon 0; set logoffonclose 1

Observatie : daca ; este la inceputul liniei, toata linia va fi tratata ca si un comentariu

10.3 Lista comenzilor

OBSERVATIE : comenzile trimise din consola trebuie sa fie precedate de caracterul "\" altfel se vor interpreta drept chat si vor fi trimise pe statia indicata de rcmdip ; lista variabilelor nu este completa, pentru a vedea toate variabilele existente, din program apasati ` si scrieti varlist <enter> ; majoritatea variabilelor au nevoie de privilegiu 8 pentru a putea fi modificate

if

Folosire : if cmd1; cmd2; cmd3
Exemplu : if testreadfile "c:\ClubTerm\Games\gameinfo.txt"; ; quit

Descriere :
Comanda “if” lanseaza cmd2 in executie daca cmd1 este adevarata iar daca nu, lanseaza cmd3.

Observatie : Comenzile cmd1, cmd2 si cmd3 nu pot fi compuse din mai multe comenzi (delimitate cu ; )

set

Folosire: set [VAR] [VAR_STRUCT]
Exemplu: set l_c1 “Quake 3 Arena – Top 10”

Descriere :
Comada “set” atribuie variabilei [VAR] o valoare sau un set de valori dat de [VAR_STRUCT]

adduser

Folosire : adduser USERSTATUS PROFILE USERNAME ENCPASSWORD
Exemplu : adduser 15 games Admin 6AE59D06ADE04010139E157EB1

Descriere :
Adauga utilizatorul USERNAME la lista cu utilizatori

USERSTATUS : poate fi orice combinatie SAU (suma) dintre nivelele standard de acces de mai jos:
1 = acces la lista de jocuri/programe
2 = acces la explorer
4 = acces la setat timp
8 = acces la optiuni si consola
16 = acces la raport

PROFILE : poate fi orice profil definit anterior cu comanda “addprofile”
USERNAME : este numele utilizatorului (nu se fac diferente intre litere mici sau mari)
ENCPASSWORD : este parola utilizatorului criptata (se face diferenta intre literele mici si mari ale parolei necriptate)

Observatie : orice comanda “adduser” trebuie introdusa numai din cadrul programului print fereastra de optiuni (comenzile "adduser" vor fi salvate in "%APPPATH%\default.cfg")

addprofile

Folsire : addprofile PROFILE PATH
Exemplu : addprofile "games" "c:\club\info\"

Descriere :
Adauga profilul PROFILE la lista cu profiluri
PROFILE : este numele profilului si poate fi orice sir de caractere
PATH : este locatia unde se gaseste directorul asociat profilului

adduserprofile

Folosire : adduserprofile USERSTATUS PROFILE USERNAME
Exemplu : adduserprofile 3 games games

Descriere :
Adauga utilizatorul profil USERNAME la lista cu utilizatori profil
Parametrii sunt la fel ca si in cazul comenzii “adduser” mai putin ENCPASSWORD care lipseste

addstation

Folosire : addstation STATION
Exemplu : addstation ST05

Descriere :
Adauga statia STATION la lista statiilor
STATION : numele statiei (numele ei de retea) pe care vreti sa o introduceti in lista statiilor

run

Folosire : run APP_PATH [APP_PARAMS] [APP_STARTUP] [APP_NAME]
Exemplu : run c:\windows\explorer.exe

Descriere : 
Lanseaza in executie orice aplicatie windows sau dos
APP_PATH : locatia executabilului
APP_PARAMS : parametrii executabilului (optional)
APP_STARTUP : locatia de start a executabilului (optional)
APP_NAME : numele aplicatiei (poate fi orice sir de caractere) (optional)

call

Folosire : call CFG_PATH
Exemplu : call "\\server\club\st05.cfg"

Descriere :
Firul de executie se transfera fisierului de configuratie specificat in CFG_PATH. Dupa ce se parcurge CFG_PATH firul de executie revine in fisierul de unde s-a plecat

quit or exit

Folosire : quit or exit
Exemplu : quit

Descriere :
Opreste aplicatia

logoff or logout

Folosire : logoff or logout

restart

Folosire : restart

shutdown

Folosire : shutdown

testreadfile

Folosire : testreadfile FILE_PATH
Exemplu : testreadfile \\server\club\licenta.txt

Descriere : returneaza adevarat daca fisierul FILE_PATH exista si este accesibil pentru citire altfel returneaza fals

testwritefile

Folosire : testwritefile FILE_PATH
Exemplu : testwritefile \\server\club\log\testw.txt

Descriere : returneaza adevarat daca fisierul FILE_PATH exista si este accesibil pentru scriere altfel returneaza fals

exshell

Folosire : exshell
Exemplu : exshell

Descriere : inchide programul si porneste interfata standard windows (default shell)

rcmd

Folosire : rcmd CMD
Exemplu : rcmd logoff

Descriere : executa o comanda pe statia indicata de variabila rcmdip cu utilizatorul setat prin rcmdusername si rcmdpassword
Observatie : utilizatorul indicat de rcmdusername si rcmdpassword trebuie sa existe pe statia indicata de rcmdip si trebuie sa aiba privelgiul necesar pentru a executa comanda CMD; inainte de a folosi rcmd specificati variabilele rcmdip, rcmdusername si rcmdpassword ;

l_c1

Folosire : set l_c1 [CLASAMENT_STR]
Valoare Initiala : "Top 10"
Exemplu : set l_c1 "Quake 3 - Top 10"

l_timeleft

Folosire : set l_timeleft [TIMELEFT_STR]
Valoare Initiala : "TIME LEFT :"
Exemplu : set l_timeleft "Timp Ramas :"

l_unitname

Folosire : set l_unitname [UNITNAME_STR]
Valoare Initiala : " Min."
Exemplu : set l_unitname "(30 min)"

l_showreport

Folosire : set l_showreport [SHOWREPORT_STR]
Valoare Initiala : "Show Report"
Exemplu : set l_showreport "Apasa aici pentru raport"

l_report

Folosire : set l_report [REPORT_STR]
Valoare Initiala : "Report"
Exemplu : set l_report "Club SRL – Activitatea Zilnica"

promptlogon

Folosire : set promptlogon 0, 1
Valoare Initiala : 1
Exemplu : set promptlogon 1

Descriere : 1 inseamna sa apara fereastra de autentificare de fiecare data cand porneste programul

logoffonclose

Folosire : set logoffonclose 0, 1
Valoare Initiala : 1
Exemplu : set logoffonclose 1

Descriere : 1 inseamna sa forteze iesirea din windows prin logoff in cazul in care se incearca inchiderea aplicatiei

disableusers

Folosire : set disableusers 0, 1
Valoare Initiala : 0
Exemplu : set disableusers 1

Descriere : 1 inseamna sa nu mai tina cont de nici o comanda “adduser” incepand cu linia urmatoare din fisierul de configuratie

watchall

Folosire : set watchall 0, 1
Valoare Initiala : 0
Exemplu : set watchall 1

Descriere : 1 inseamna sa avertizeze sonor si vizual in cazul in care oricarei statii din lista cu statii i se termina timpul

unittime

Folosire : set unittime UNITTIME
Valoare Initiala : 1
Exemplu : set unittime 30

Descriere : Cea mai mica unitate cu care opereaza programul are UNITTIME minute. De obicei se lucra cu UNITTIME = 1 adica un minut, dar se poate seta si la 30 minute sau 60 minute.

unitprice

Folosire : set unitprice UNITPRICE
Valoare Initiala : 167
Exemplu : set unitprice 100

Descriere : Se seteaza costul unitati ca fiind UNITPRICE

logpath

Folosire : set logpath PATH_STR
Exemplu : set logpath "c:\club\log\"

Descriere : In locatia PATH_STR se va tine jurnalul statiei.

timepath

Folosire : set timepath PATH_STR
Exemplu : set timepath "\\server\club\time\"

Descriere : In locatia PATH_STR se va tine fisierul cu timpul statiei. Acesta este necesar pentru ca in caz ca se reseteaza calculatorul, timpul sa nu se piarda.

defaultuser

Folosire : set defaultuser USERSTATUS PROFILE USERNAME
Valoare Initiala : 0 "" "Anonymous"
Exemplu : set defaultuser 1 games games

Descriere : defaultuser este utilizatorul cu care opereaza programul in cazul in care nu se autentifica nici un alt utilizator. De exemplu daca promptlogon este setat pe 0, atunci programul intra automat cu defaultuser, la fel si daca promptlogon este 1 si se da CANCEL in fereastra de autentificare.

Toate drepturile de autor sunt rezervate Marius David (c) 1999-2000. Tel : 092 690399, eMail : mariusd@mail.dnttm.ro